home *** CD-ROM | disk | FTP | other *** search
/ Aminet 39 / Aminet 39 (2000)(Schatztruhe)[!][Oct 2000].iso / Aminet / gfx / board / CyberPiPView.lha / CyberPiPView / CyberPiPView.doc next >
Encoding:
Text File  |  2000-07-04  |  7.3 KB  |  181 lines
  1.                      CyberPiPView
  2.             © 1998-2000 by Stephan Rupprecht
  3.                        All rights reserved.
  4.     
  5.  
  6. COPYRIGHT AND DISCLAIMER
  7.  CyberPiPView is copyrighted 1998-2000 by Stephan Rupprecht. 
  8.  All rights reserved. This program is freeware, so no financial  
  9.  donations required. Redistribution allowed if the package is 
  10.  left unchanged. The author is not responsible for any damage 
  11.  caused by the use or misuse of this documentation and/or the
  12.  program(s) it describes.
  13.  
  14.  
  15. REQUIREMENTS CGFX
  16.  - cybergraphics v3/4
  17.  - cv64/3d, piv, bvision/cvppc gfx-board
  18. REQUIREMENTS P96
  19.  - p96 with *cgxvideo emulation* (v1.38 or better)
  20.  - piv or cv64/3d
  21.  
  22.  
  23. DESCRIPTION
  24.  CyberPiPView is another picture viewer with usage of the
  25.  datatypes. This program uses the videolayer feature of a 
  26.  cv64-3d/piv/cvppc to display pictures in 16bit no matter 
  27.  which resolution the current screen has (<=8bit, 15/16/24bit).
  28.  This means that any picture can be shown in up to 65536
  29.  colors even if the current screen just has 8 colors. The
  30.  gfx processors automatically scales the picture to fit on
  31.  the screen. When the window gets resized, the picture will
  32.  be resized, too.
  33.  
  34.  
  35. USAGE
  36.  From shell 
  37.  ----------
  38.  FILES/M:    filename(s) or AmigaDOS pattern(s) of the image(s)
  39.                 which shall be shown.             
  40.  REQUESTER/S:    pop-up filerequester even when CyberPiPView was started
  41.         with filenames given.
  42.  PUBSCREEN/K:    name of pubscreen to show the pix on (must be a cgfx one).
  43.  COLORKEY/S:    Normally the video layer is the front most part of the screen,
  44.         so if you move a window in front of the layer, the window will
  45.         remain in the background. When using the COLORKEY option
  46.         windows can cover the video layer (see also known problems
  47.         section).
  48.  DELAY/N/K:    turns slide show mode on, each picture is shown for DELAY 
  49.         seconds.
  50.  CENTER/S:    center the window on the screen.
  51.  NOSCALING/S:    disable software-scaling (when resizing the window). Useful
  52.          for Permedia2 based boards which can do downscaling.
  53.  COLORREDUCTION/K: when setting this option to ISLOW, CyberPiPView will
  54.          use a slightly different way to reduce the image data 
  55.          to 16bits. This will give you better quality (?) but
  56.          is much slower than the default method (IFAST).
  57.  FULLSCREEN/S:    this will make the window as large as the screen.
  58.  KEEPASPECT/S:  when setting this option, the program will try to preserve
  59.          the aspect ratio of the picture.
  60.  
  61.  
  62.  From WB
  63.  ----------
  64.  CyberPiPView can be started ...
  65.  1. As default tool
  66.  2. By multi selection (click on the program icon, then select the
  67.     files to view [hold the shift key down while doing this] and
  68.     finally do a double click to start CyberPiPView).
  69.  3. By a double-click, a requester will pop up then.
  70.  
  71.  All commandline options are available as tooltypes, too.
  72.  
  73.  The window
  74.  ----------
  75.  You can resize a picture using the sizegadget. Clicking on the closegadget or
  76.  pressing esc/rmb terminates CyberPiPView. Pressing the lmb (or any key) starts
  77.  displaying the next picture in the list (if there's one:).
  78.  
  79.  
  80. KNOWN PROBLEMS
  81.  - p96 v2: when using COLORKEY/S, the cgxvideo emulation of p96 will
  82.    throw enforcer hits.
  83.  - Sometimes crashes your machine :( according to F.Mariak
  84.    this could be a hardware problem of the virge S3 chip. Actually,
  85.    Frank doesn't have much documentation on it, so if someone has
  86.    a good documentation on it ...
  87.    It has been reported that the vlayer feature works stable on p96.
  88.    cgx 4.3 works very stable, too (at least the ViRGE driver).
  89.  - Downscaling isn't supported by the ViRGE chip, you might get trash
  90.    at a certain picture size. v2.0 of CyberPiPView works around this
  91.    problem by doing "software" scaling.
  92.  - stripes at the bottom / right border (hardware bug?).
  93.  - When using hi-resolutions you may see flickering stripes, to avoid
  94.    this turn-off (default) the COLORKEY option. Unfortunately deactivating 
  95.    COLORKEY doesn't always help because of the high bandwidth which is
  96.    required. Using CyberPiPView on screens >=15 bit doesn't make much
  97.    sense at all, use CyberWindow by M.Scheler instead.
  98.  - Please note that you can't grab the contents of a video layer.
  99.  - Not a bug: Please set the MULTIMEDIAMEM tooltype to YES (cvision3d
  100.    driver)! Otherwise you'll get an "out of memory" error (This is not
  101.    required for the latest cgx releases anymore).
  102.  - BVision/CVPPC users: Make sure that you've the VLAYER tooltype set
  103.    to DESTRUCTIVE and at least cgx v4.3 installed.
  104.  
  105.  
  106. HISTORY
  107.  1.0    first public release
  108.  1.1    now checks if a cv64/3d is installed (R. Reiswig),
  109.     didn't close libs when ReadArgs() failed,
  110.     window border no longer covers parts of the pictures,
  111.     added COLORKEY option (see known problems section),
  112.     added DELAY option. 
  113.  1.2    removed some enforcer hits
  114.  1.3    now works with p96 picture.dt (forgot to get a new
  115.     bitmap pointer after remapping).
  116.  1.4    now works with p96 cgxvideo emulation, filerequester
  117.     remembers last path, changed handling of window
  118.  1.5    newer releases of cgxvideo.library work buffered for both Z2
  119.     and Z3 machines. This slows down CyberPiPView, fixed 
  120.     that problem by changing the way the layer is filled up.
  121.  1.6    newer releases of p96 seem to have a different LibID string
  122.     for their cgfx emulation. That's why cyberpipview failed
  123.     to work with a piv. Fixed that by removing the check for
  124.     a specific gfx-board <reported by several users>. compiled
  125.     with gnuc. v1.5 changes made the program crash on p96.
  126.  1.7    no longer refuses to work with a piv when cgfx is installed
  127.      (latest cgfx version supports piv video overlay). now opens
  128.      a simple refresh window to reduce memory usage <Frank Mariak>.
  129.  1.7a    Whoops! compiled wrong source code (old MaxonC++ one).
  130.  2.0    rewrote most of the code: for pictures that don't fit on the
  131.      screen "software" scaling is done. this is also done when
  132.      making the window smaller and can be disabled with NS=NOSCALING/S.
  133.      added CENTER/S option. improved input handling. this version
  134.      was released to my HP.
  135.  2.1    the closegadget didn't terminate the program. the titlebar of the
  136.      window is now used to display status messages (loading, converting
  137.      aso.). sometimes when resizing the window, "software" scaling was
  138.      done even though hardware scaling could be used. now preserves the
  139.      aspect ratio of a picture when it doesn't fit on the screen (this
  140.      is done by dividing the picture size by a power of 2). could free
  141.      some memory twice on error conditions.
  142.  2.2    speeded up scaling code a bit. a few cosmetical changes. added
  143.      CR=COLORREDUCTION/K option. supports ham and ehb images through
  144.      pictdt v44, now. reduced memory usage and improved speed when
  145.      p96 pictdt or os3.5 pictdt is used.
  146.  2.3    the program displays the scaled size (this might differ a bit from
  147.      the real image size as the layer will have a width that is a multiple
  148.      of 16) of the image in pixels as well as in percent, now. added
  149.       FS=FULLSCREEN/S option <Joni Halme>.
  150.  2.4    fixed enforcer hit on startup <Phillipe Bovier>.
  151.  2.5    added KA=KEEPASPECT/S option.
  152.  
  153.  
  154. SPECIAL THANKS GO TO
  155.  Frank Mariak for his help and reworking the cgfx autodocs and 
  156.  includes ;)
  157.  R. Reiswig for his suggestions.
  158.  Emiliano Esposito for his bug report.
  159.  Jan Britsch and Olaf Krafft for beta testing and reporting bugs.
  160.  
  161.  and to all others who sent me mails ...
  162.  
  163.  
  164. AUTHOR
  165.  
  166.  Please send bug reports and ideas to:
  167.  
  168.      Stephan Rupprecht
  169.     Apfeldweg 1
  170.     D44359 Dortmund
  171.     Germany
  172.  
  173.  Send emails to
  174.  
  175.     stephan.rupprecht@gmx.de
  176.     stephan.rupprecht@web.de
  177.  
  178.  WWW
  179.  
  180.     http://stephan.2xs.de
  181.